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Preface 



This manual is a guide to the installation of DATATRIEVE-11 on the follow- 
ing operating systems: 

IAS V2.0 

RSX-11M V3.1 

RSTS/E V6C 

This manual is written for the system manager who is responsible for perform- 
ing the installation procedures. 

The information in this manual is organized in the following manner: 

Chapter 1 comments about the installation kit, describes how to physically 
mount the distribution media, and indicates errors that might occur during 
installation. 

Chapter 2 describes how to install DATATRIEVE-11 on an IAS system. 
Chapter 3 describes how to install DATATRIEVE-11 on an RSX-11M system. 

Chapter 4 describes how to install DATATRIEVE-11 on an RSTS/E system. 

Chapter 5 describes possible uses of the Data Dictionary Extend Program, 
extending DATATRIEVE-11 task space, and the Dictionary Compression 
Utility Program. 

Appendix A contains the Acceptance Test Procedure. 



Documentation Conventions 

The following conventions are used throughout this manual to illustrate the 
DATATRIEVE installation procedures: 

HD The symbol ® represents the non-printing carriage 
return key. 

lower case Lower-case text indicates variable information that you 
UPPER CASE supply; upper-case text indicates literal information that 
you enter as shown. 

color Information that you type during the installation proce- 
dure is indicated in red. 

The circumflex (*) represents a control character. That 
is, Istrl/z) is the same as 7. 
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Chapter 1 

General Information 



1.1 inaiaiiciiiGii r\n 

You receive a kit containing all material necessary to install 
DATATRIEVE-11 on the computer at your site. Check the contents against 
your original order. If there are any discrepancies between what you ordered 
and what your received, report the discrepancies to your sales representative. 

1.2 Physically Mounting Distribution Media 

1. For magtape distribution proceed as follows: 

a. Obtain the magtape from your kit and mount it on a free tape drive 
with the write enable ring removed. 

b. Ensure that the FILE PROT (file protection) indicator light is lit. 

c. Ensure that the tape is at its load point (the LD PT indicator light is 
lit). 

d. Set the ON LINE/OFF LINE switch on the tape unit to ON LINE, and 
ensure that the RDY (ready) indicator light is lit. 

2. For disk cartridge distribution proceed as follows: 

a. Obtain the disk cartridge from your kit and insert it into a free disk 
drive unit. 

b. Place either the LOAD/RUN switch for the RK05 or the RUN/STOP 
switch for the RK06 and RK07 to run position. Press the LOAD button 
on the RL01. 

c. Ensure that the RDY (ready) indicator light is lit. 

d. Ensure that the WR PROT (write protect) indicator light is lit. 
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1.3 Possible Errors during Installation 



When you are performing your installation procedures, you may get certain 
error messages. Should you get one of these messages, refer to this section. 

A possible error that can occur during the DATATRIEVE-11 installation is 
the failure of the QDICT program. If such an error occurs, the following 
message is printed on the terminal. 

RMS ERROR STATUS:xxx 

where xxx is an octal RMS error code. Refer to the IAS/RSX-11M RMS-11 
MACRO Programmer's Manual for the meaning of the error code and possible 
recovery procedures. When you have corrected the error, rerun the command 
file. 

If the following message appears: 

WRITE SHARING NOT AVAILABLE, PROCEEDING ANYWAY 

write-locking has not been installed on the system. The installation continues 
from this point; however, you must install write-locking and reinstall 
DATATRIEVE-11. A system generation may be required to install write- 
locking. With write-locking installed, you can rerun the command file. 

Another possible error is the termination of the QDICT task build. If the task 
build terminates with the following error message: 

TKB -- *DIAG*S UNDEFINED SYMBOLS SEGMENT SAVREG 

The most likely cause is that RMS-11K has not been installed. To determine 
whether or not RMS-11K has been installed, examine the QDICT.MAP file. 
If these symbols: 



$CL03E 
$CRE3E 
$OPE3E 



$CON3E 

$DIS3E 

$PUT3E 



are undefined, RMS-11K has not been installed on the system. 
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Chapter 2 

IAS V02 Installation Procedures 



This chapter is a guide to the installation of DATATRIE VE-1 1 on the IAS 
V02 Operating System. 

The information in this chapter is organized in the following manner. 

Section 2. 1 presents both the software and hardware requirements needed to 
install DATATRIE VE-1 1 . 

Section 2.2 contains the procedures to install DATATRIEVE-11 on your 
system. 

Section 2.3 lists the DATATRIEVE-11 files that reside in the target UIC's. 

2.1 System Requirements 

The software and hardware listed in Sections 2.2.1 and 2.2.2 respectively are 
required to install DATATRIEVE-11. 

2.1.1 Software Requirements 

IAS Version 2 

RMS-11K Version 1 (for RMS Indexed Record I/O) 

RMS-11K software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must first install it before 
installing DATATRIEVE-11. Get the kit containing the RMS-11K software, 
and install this software following the procedures presented in the RMS-11K 
IAS Installation Guide. 
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2.1.2 Hardware Requirements 



The following system configuration is required for DATATRIEVE-11 
installation. 



CPU 

MEMORY 

TERMINAL 

TAPE 

or 
DISK 

DISK SPACE 



PDP-11 with EIS hardware. 

64K bytes above the minimum operating system requirements. 
Any supported terminal (hard copy terminals are preferred.) 
One 9-track magtape drive. 

RK05, RK06, RK07, or RL01 drive. 

2300 free blocks must be available in the target account for 
DATATRIEVE-11. 



2.2 Procedures for Installing DATATRIEVE-11 on IAS V02 

2.2.1 Summary of Installation Procedures 

1. Log in under a privileged account([l,x]). 

2. Physically mount the distribution medium as described in Chapter 1. 

3. Logically mount the distribution medium. 

4. Copy the distribution medium into your account (then remove the distri- 
bution medium). 

5. Execute the command file DTRIAS.CMD. 

6. Log off the system. 



2.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form ([l,x]). 



2.2.3 Logically Mount the Distribution Medium 

1. For magtape distribution use the command 

M0UNT/F0R/N00P dev. DTR11 © 

2. For disk cartridge distribution use the command 

M0UNT/N00P dew: DTR11 © 

where dev: is the device specification of the drive containing the distribution 
medium. 
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2.2.4 Copy the Distribution Medium 



1. To copy the data on the magtape into the target account type the command 

COPY dew : C 1 »1 ]*.*/DOS *♦* ® 

2. To copy the data on the disk cartridge into the target account type the 
command 

COPY d e v : C 1 » U * . * * . * © 



At this time, data on the distribution medium is copied into the target 
account, when the copying operation is complete, the prompt PDS> appears 
on your terminal. 

To logically dismount the distribution medium, type the command 

DISMOUNT deys (HD 

When the DISMOUNT COMPLETE message appears at your terminal, re- 
move the distribution medium and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution): 

PDS> M0UNT7F0R/N00P MM 1 : DTR11 

MOUNT-**MOLUME INFORMATION** 

DEVICE =MM1 

CLASS =FOREIGN 

UIC =C 1 »1 ] 

ACCESS = ERWED *RWED *RWED fRWED] 

CHARAC = C FOR »ATCH *DCF ] 

PDS>COPY MM1:C1 »U*.*/DOS *.* 

PDS> DISMOUNT MM 1 : 

DMO -- MM 1 : ** DISMOUNT COMPLETE ** 
PDS> 

2.2.5 Executing the Command File DTRIAS.CMD 

Now type: 

@DTR I AS © 

DTRIAS.CMD is the command file that installs D ATATRIE VE-1 1 into your 
system. As part of the command file, the D ATATRIE VE-1 1 Acceptance Test 
is executed. During the Acceptance Test, you are required to enter data. 
Observe the test as it outputs and respond as the test requests input. 
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The following example is the log printed as a result of command file execu- 
tion. Note that the Acceptance Test has been deleted from the example. The 
complete Acceptance Test is in Appendix A. 



PDS> gDTRIAS 
! 

! CREATE DATATRIEUE DIRECTORIES 
i 



REMOVE ***DTR 



REM 


TASK ***DTR NOT 


IN SYSTEM 


CREATE/ 


DIR LB:Cllr 


1303 


CREATE/ D. IK LB iC 111 


r 1303 


CREATE/DIR LB:C311 


f .1 30 :i 


! COPY 


FILES TO PROPER 


LOCATIONS 


COPY 


QUI AS, MAC 


LB J i: 311 y 1.30:1*.* 


DELETE 


GDI AS. MAC J* 




COPY 


QE IAS. LNK 


LB: CI 1» 1303*.* 


DELETE 


QEI AS . LNK i * 




COPY 


QEI AS. ODL 


lb: mi s 1303*.* 


DELETE 


QE IAS ♦ ODL f * 




COPY 


DTRI AS ♦ ODL 


lb: i::ii » i.3o::i*.* 


DELETE 


DTRI AS. ODL J* 




COPY 


DTRI AS. LNK 


LB: Cl 1 y .1.303*,* 


DELETE 


DTRI AS ♦ LNK ? * 




COPY 


RMS I AS, ODL 


LB J L 1 1 r .!. 303 * , * 


DELETE 


RMS I AS. ODL J* 




COPY 


QC I AS. LNK 


lb: en f 1303*.* 


DELETE 


QCIAS.LNKJ* 




COPY 


QC I AS. ODL 


LB * C 1 1 * 1 303* ♦ * 


DELETE 


QC I AS. ODL?* 





INSTALL DATATRIEVE OBJECT LIBRARY 



M A C / B J : Q D L B : C 3 1 1 f 1 3 3 Q D I A S 

08M0:23 Size: 26K CPU: 0.11 Ststus: Success 

LI BR INSERT DTRLIB QD 

uur f jli i r\i~i r> ♦ uux? i_jp ♦ i_ x r x jt ♦ * 

DELETE DTRLIB ♦ OLB ? * 

DELETE QD.OBJJ* 

! 

i INSTALL DATATRIEVE TASKS 
i 

SQDIAS.LNK 

LIN K /OVER L A Y t Q D I A S / T A S K : Q D I C T / P T / M A P * Q B I C T / READ 
08 Mi: 52 Size: 27K CPU ♦ 22.10 Status: Success 
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RUN QDICT 
08 Mi t 54 

CREATING QUERY DICTIONARY 
CREATING MESSAGE FILE 
P P U L AT I NO M E S S A G E F I L E 
BYE 

08: 46: 22 Size: 2 IK CPU : 21*46 

@LB : C 1 1 r 1303DTRI AS • LNK 

L INK / V E R L A Y : LB : C J. .1. r 1 303 D T R I A 5 - 

/task: lb: cm :udtr/opt/map u.b: cm * 13o:idtr/mul/read 

08J51 : 45 Size: 27K CPU : 48.96 Status: Success 

@LB : C 1 1 » 1 30 .1 QE I AS • LNK 

LINK / V E R L A Y : LB : C 1 1 r 1 3 1 EI AS - 

/task:lb: cn » i."]qdext/opt/map:lb: cm f :i.3o:]qdext/re ad 

08:52:31 Size: 27K CPU : 13.98 Status: Success 
! 

@lb : c 1 1 ? 1 30 :j qc i as • lnk 

L INK /OVERLAY I LB J C 1 1 r 1 30T.I QC IAS - 

/task : lb : c 1 1 r i dqcprs/opt/map : lb : i: 1 1 1 , i 3o::iqcprs/read 

08:53:53 Size: 27K CPU : 26.60 Status: Success 

SET PROTECTION L B : C 1 1 2 1 Q U E R Y . D I C U R I... D t U R E 

INSTALL LB:Cllrl3DTR 
i 

! RUN DATATRIEME ACCEPTANCE TEST 
i 

DTR 6DTR.TST 




The DATATRIE VE-1 1 Acceptance Test Procedure 
is contained in Appendix A. 



EXIT 

BYE 

! 

! SAME YACHT DEMO FILE 
! 

COPY YACHT .DAT LB i C 1 r 2 1 * . * 

DELETE YACHT ♦ DAT ? * 

! END OF DATATRIEME INSTALLATION 



PDS> 



2.2.6 Log Off the System 

Log off the system after the DTRIAS.CMD file has completed execution (you 
observe the PDS> prompt). 
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DATATRIEVE-11 Files 



When DATATRIEVE-11 has been installed, the following files reside in the 
indicated UIC's. Note that the [SELF] designation represents your privileged 
account. 



UIC 


FILE NAME 


DESCRIPTION 


ri 1 1 

li - ij 


FlTT?T TR OT R 


Datatrieve object library 




HTTTPRV r>TP 


Data dictionary 


11, M 


V^Uilirt I .lVloljr 


Message file 


ri oi 


YAUri 1 .UAL 


Acceptance test data file 


Ml 1 QAl 

Ui,loUJ 


FlTRTAQ T 


Datatrieve task-build command file 


Lll,loUj 


tytrtaq nr»T 

U 1 IvlrVO .KJLJLd 


Datatrieve overlay description file 


Lll,loU| 


f~\/~ij ACT MIT 


uuMJrivEjoo program tasK-Duiid command rile 


n 1 1 3fii 
Lil,loUJ 




COMPRESS program overlay description file 


nil *5m 

L±l,loUJ 


HPT AC T WW 


EXTEND program task-build command file 


ri i i qai 
Lli,IoUJ 


ni^T a q. nm 

Ic^liilAo . \JDLi 


EXTEND program overlay description file 


ri 1 1 OAi 
lll,loUJ 


KM olAo . UJJJu 


RMS overlay description file 


ri i 11 
llljlj 


JJ I iv. 1 oxv 


Datatrieve task image 


n i n 


npppc TQlf 
v^^lr rto. 1 oxV 


jjictionary i^ijivii^jxiloo program 


ri i n 
111,1] 


v^JJJiA. 1 . 1 orv 


jjicuonary Hi .a i HiIn jj program 


nil i Qm 


r»nrR map 

JJ 1 rt.lVlAr 


Datatrieve map file 


nil i qai 
Llll,loUJ 


nrpRQ map 


Dictionary COMPRESS program map file 


[111,130] 


QDEXT.MAP 


Dictionary EXTEND program map file 


[311,130] 


QDIAS.MAC 


Dictionary file-name source module 


[SELF] 


DTR.TST 


Acceptance test command file 


[SELF] 


MSGS.SEQ 


Message file (distribution format) 


[SELF] 


QDIAS.LNK 


Dictionary build program task-build command file 


[SELF] 


QDIAS.ODL 


Dictionary build program overlay description file 


[SELF] 


QDICT.MAP 


Dictionary build program map file 


[SELF] 


QDICT.TSK 


Dictionary build program 


[SELF] 


YACHT. SEQ 


Acceptance test data file (distribution format) 
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Chapter 3 

RSX-11M V03 Installation Procedures 



This chapter is a guide to the installation of DATATRIE VE-1 1 on the 
RSX-11M V03.1 Operating System. 

The information in this chapter is organized in the following manner: 

Section 3. 1 presents both the software and hardware requirements needed to 
install DATATRIE VE-1 1 

Section 3.2 contains the procedures to install DATATRIEVE-11 on your system. 
Section 3.3 lists the DATATRIEVE-11 files that reside in the target UIC's. 

3.1 System Requirements 

The software and hardware listed in Section 3.1.1 and 3.1.2 respectively are 
required to install DATATRIEVE-11. 

3.1.1 Software Requirements 

RSX-11M Version 3.1 Mapped System 

RMS-11K Version 1.5 (for RMS Indexed Record I/O) 

RMS-11K Software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must first install it before 
installing DATATRIEVE-11. Get the kit containing the RMSll-K software, 
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and install this software following the procedures presented in the RMS-11K 
RSX-11M Installation Guide. 



3.1.2 Hardware Requirements 



The following system configuration is required for DATATRIEVE-11 
installation. 



CPU 

MEMORY 

TERMINAL 

TAPE 

or 
DISK 

DISK SPACE 



PDP-11 with EIS hardware. 

64K bytes above the minimum operating system requirements. 
Any supported terminal (hard copy terminals preferred). 
One 9- track magtape drive. 

RK05, RK06, RK07 or RL01 drive. 

2300 free blocks must be available in the target account for 
DATATRIEVE-11. 



3.2 Procedures for Installing DATATRIEVE-11 on RSX-11M V03 

3.2.1 Summary of Installation Procedures 

1. Log in under a privileged account ([l,x]). 

2. Physically mount the distribution medium as described in Chapter 1. 

3. Allocate (and mount, if disk) the distribution medium. 

4. Copy the distribution medium into your account (then remove the distri- 
bution medium). 

5. Execute the command file DTR11M.CMD. 

6. Log off the system. 

3.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form [l,x]. 

3.2.3 Allocate (and Mount, if Disk) the Distribution Medium 

1. For magtape distribution use the command 

ALL deu : (ret) 
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2. For disk cartridge distribution use the commands 

ALL d e m : © 

MOU dev :DTR1 1 ® 

where dei>: is the device specification of the drive containing the distribution 
medium. 

3.2.4 Copy the Distribution Medium 

1. To copy the data on the magtape into the target account type the command 

FLX SY:/RSX=dev: El »1]*.*/D0S ® 

2. To copy the data on the disk cartridge into the target account type the 
command 

P I P SY : / N V= d e v : C 1 * U * . * © 
At this time, data on the distribution medium is copied into the target 

nstsisvl WTX^n-n 4-l*n nnn.n^^n ^ ^1 4-~U ~ ^ 

ai.wuui. Tuicii me i/up^mg upciowuii io ^umpictc, mc piuiiipt s appeals un 

your terminal 

To logically dismount the magtape distribution medium, type the command 
DEA dev: (H) 

For the disk distribution, type the commands 

DMO dev: W> 
DEA den: dD 

When the prompt appears on your terminal, remove the distribution medium 
and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution): 

> A L L MM 1 : 

>FL)< SY:/RSX=MM1 : CI » 1 ] * »*/DOS 

> DEA MM 1 : 



3.2.5 Executing the Command File DTR11M.CMD 

Now type 

SDTR11M m 

DTR11M.CMD is the command file that installs D ATATRIE VE-1 1 into your 
system. As part of the command file, the D ATATRIE VE-1 1 Acceptance Test 
is executed. During the Acceptance Test, you are required to enter data. 
Observe the test as it outputs and respond as the test requests input. 
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The following example is the log printed as a result of command file execu- 
tion. Note that the Acceptance Test has been deleted from the example. The 
complete Acceptance Test is in Appendix A. 

>6DTR11M 

> f 

>i COPY TASK BUILD COMMAND FILES 

> t 

>REM ♦♦♦DTR 

REM — TASK NOT IN SYSTEM 

>P IP LB i C 1 1 24 3 /NV=QE 1 1 M ♦ TKB 

>PIP QE1 1M ♦ TKB i */DE 

>PIP LB? CI >243/NV=QEliM.0DL 

>PIP QE1 1M ♦ ODL r #/DE 

>P I P LB 1 C 1 r 24 :i /NV-DTR 1 1 M ♦ TKB 

>PIP DTR1 1M ♦ TKB i #/DE 

>P IP LB I C 1 r 24 3 /N V=DTR 1 1 M ♦ ODL 

>PIP DTR11M.0DL**/DE 

>P IP LB illr 243 /NV-RMS 1 1 M . ODL 

>PIP RMS11M.0DLJ*/DE 

>PIP LB J CI »24D/NV=QC11M.TKB 

>PIP QC11M.TKBJ*/DE 

>PIP LB J C .1 * 24 3/NV"QCl 1M ♦ ODL 

>PIP QC11M.0DL»*/DE 

> ! 

>! INSTALL DATATRIEVE OBJECT LIBRARY 

> j 

>MAC QD=QD11M 

>LBR DTRLIB/IN--QD 

>PIP LBJ CI t 13/NV=DTRLIB»OLB 

>PIP DTRLIB ♦ OLE r */DE 

>PIP QD.OBJ?*/DE 

> i 

>! INSTALL DATATRIEVE TASKS 

> I 

'•TKB 6QD11M.TKB 
>RUN QDICT 

CREATING QUERY DICTIONARY 
CREATING MESSAGE FILE 
POPULATING MESSAGE FILE- 
BYE 

>TKB 0LBJC1 >24 3DTR11M.TKB 
>TKB BLB:C1»243QE11M.TKB 
>TKB 6LB:Cl»243QCliM.TKB 

>INS LB : CI r 54. 3 DTR 

> i 

>! RUN DATATRIEVE ACCEPTANCE TEST 

> I 

>DTR @DTR*TST 



• The D ATATRIEVE-1 1 Acceptance Test Procedure 

>PIP LB t C 1 r 2 3 /NV-^ YACHT ♦ DAT 
>PIP YACHT ♦ DAT ? */DE 

> I 

>! END OF DATATRIEVE INSTALLATION 

> j 

>@ <EOF> 
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3.2.6 Log Off the System 

Log offthe 'system aTterthe "^T^nMXHSIDTile"'Tias complefed execution (you 
observe the > prompt). 

DATATRIEVE-11 Files 

When DATATRIEVE-11 has been installed the following files reside in the 
indicated UIC's. Note that the [SELF] designation represents your privileged 
account. 



TTTP 




UJii3V/JUr 1 lull 


[1,1] 


DTRLIB.OLB 


Datatrieve object library 


[1,24] 


DTR11M.ODL 


Datatrieve overlay description file 


[1,24] 


DTR11M.TKB 


Datatrieve task-build command file 


[1,24] 


QC11M.ODL 


COMPRESS program overlay description file 


[1,24] 


QC11M.TKB 


COMPRESS program task-build command file 


[1,24] 


QE11M.ODL 


EXTEND program overlay description file 


[1,24] 


QE11M.TKB 


EXTEND program task-built command file 


[1,24] 


RMS11M.ODL 


RMS overlay description file 


[1,2] 


QUERY.DIC 


Data dictionary 


[1,2] 


QUERY.MSG 


Message file 


[1,2] 


YACHT.DAT 


Aceptance test data file 


[1,34] 


DTR.MAP 


Datatrieve map file 


[1,34] 


QCPRS.MAP 


Dictionary COMPRESS program map file 


[1,34] 


QDEXT.MAP 


Dictionary EXTEND program map file 


[1,54] 


DTR.TSK 


Datatrieve task image 


[1,54] 


QCPRS.TSK 


Dictionary COMPRESS program 


[1,54] 


QDEXT.TSK 


Dictionary EXTEND program 


[SELF] 


DTR.TST 


Acceptance test command file 


[SELF] 


MSGS.SEQ 


Message file (distribution format) 


[SELF] 


QD11M.MAC 


Dictionary file-name source module 


[SELF] 


QD11M.ODL 


Dictionary build program overlay description file 


[SELF] 


QD11M.TKB 


Dictionary build program task-build command file 


[SELF] 


QDICT.MAP 


Dictionary build program map file 


[SELF] 


QDICT.TSK 


Dictionary build program 


[SELF] 


YACHT.SEQ 


Acceptance test data file (distribution format) 
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Chapter 4 

RSTS/E V06C Installation Procedures 



This chapter is a guide to the installation of DATATRIE VE-1 1 on the RSTS/E 
V06C Operating System. 

The information in the chapter is organized in the following manner: 

Section 4. 1 presents both the software and hardware requirements needed to 
install DATATRIE VE-1 1 . 

Section 4.2 contains the procedures to install DATATRIEVE-11 on your system. 
Section 4.3 lists the DATATRIEVE-11 files that reside in the target accounts. 

4.1 System Requirements 

The software and hardware listed in Sections 4.2.1 and 4.2.2 respectively are 
required to install DATATRIEVE-11. 

4.1.1 Software Requirements 

RSTS/E, Version V06C 

RSX.RTS - The RSX run-time system 

RT.RTS - The RT-11 run-time system 

SYSLIB.OLB - The RSX system object library 

RMS11.RTS - The RMS-11 run-time system 

PIP.SAV - Peripheral Interchange Program in account [1,2] 

TKB.TSK - The Task Builder in account [1,2] 

MAC.TSK - The MACRO-11 assembler in account [1,2] 

RMS-11K - Version 1.5 (for RMS Indexed Record I/O) 

RMS-11K software must be present on your computer prior to installing 
DATATRIEVE-11. If RMS-11K is not present, you must install it before 
installing DATATRIEVE-11. Get the kit containing the RMS-11K software, 
and install this software following the procedures presented in the RMS-11K 
RSTS/E Installation Guide. 
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4.1.2 Hardware Requirements 



The following system configuration is required for DATATRIEVE-11 
installation. 



CPU 

MEMORY 

TERMINAL 

TAPE 

or 
DISK 

DISK SPACE 



PDP-11 with EIS hardware. 

64K bytes above the minimum operation system requirements. 
Any supported terminal (hardcopy terminals are perferred). 
One 9-track magtape drive. 

RK05, RK06, RK07 or RL01 drive. 

2300 free blocks must be available in the target account for 
DATATRIEVE-11. 



4.2 Procedures for Installing DATATRIEVE-11 on RSTS/E V06C 

4.2.1 Summary of Installation Procedures 

1. Log in under a privileged account [l,x]. 

2. Physically mount the distribution medium as described in chapter 1. 

3. Logically assign the magtape or mount the disk distribution medium. 

4. Copy the distribution medium into your account (then remove the 
distribution) . 

5. Execute the BUILD program. 

6. Log off the system. 

4.2.2 Log in Under a Privileged Account 

Log into your computer system under a privileged account in the form [l,x]. 

4.2.3 Logically Assign the Magtape or Mount the Disk 
Distribution Medium 

1. For magtape distribution use the command 
ASSIGN deu : * DOS (H) 

2. For disk cartridge distribution use the command 

MOUNT dew :DTR1 1/R0NLY (H) 

where dev. is the device specification of the drive containing the distribution 
medium. 
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4.2.4 Copy the Distribution Medium 

To copy the data on either the magtape or disk distribution into the target 
account type the commands 

RUN *PIP.SAV ® 
**,*=dev:Cl»l]*.* © 

* •'• Z 

At this time, data on the distribution medium is copied into the target 
account. When the copying operation is complete, the prompt Ready appears 
on your terminal. 

To logically dismount the magtape distribution medium, type the command 
DEASSIGN dev: © 

For the disk distribution, type the command 

DISMOUNT dev.DTRll © 

When the Ready prompt appears on your terminal, remove the distribution 
medium and store it in a safe place. 

The installation dialog to this point will be similar to the following example 
(magtape distribution). 

Read v 

ASSIGN MMO: .DOS 
Read v 

RUN $PIP.SAU 

* * ♦ * = MMO : C 1 1 1 3* . * 

* -z 

Read y 

DEASSIGN MMO: 
Read v 

4.2.5 Executing the BUILD Program 

Now type 

RUN $BUILD © 

The computer initiates the following dialog; respond as shown. 

BUILD VOBC-03 RSTS V06C-03 SYSTEM 52547 

System Build <No>? ® 

Source Input Device <SY:>? © 

Library Output Device <SY>? © 

Library Account < C 1 1 2 3 >? © 

Control File is? DTRSTS » CTL © 

*** Copy intf file SY : DTRSTS . CTL to SY-.BUILD.TMP 
BUILD Detach in tf, ♦ ♦ 
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The BUILD program then installs D ATATRIE VE-1 1 . The dialog continues, 
as shown by the following example. Note that you must enter the command 
DTR ©DTR.TST to run the Acceptance Test. 

"X 

HELLO 

RSTS V06C-03 Basic-f 2/Cobol Job 17 KB20 29"-AusS-78 12: 42 PM 
* 1/250 
Password J 

J oh 12 is detached under this account 
Job number to attach to? 

1 other user is losJSed in under this account 



Ready 

ASSIGN SY;SYSDSK . 
Read y 

ASSIGN SYt SYSTEM 
Read':; 

ASSIHN ; : lr 21 
Ready 

ASSIGN SY t INPUT 
Re<idy 



i hak.v- sure- PXS.RTS and RT11*RTS are present 
i 

RUN *UTJLTY 

U TIL TY V06O03 RSTS VOAC-03 Bas i c + 2/ Cobo 1 
♦ADD RSX 

?Name or account now exists • in ADD 
♦ADD RT11 

?Ns r»« e o r a c c o u r» t n o w e x i s t s -• i n A If D 
*CCL DTR- 

?C3n ' t find file or account - in CCL 
♦EXIT 

Ready 



! Install Datatrieve object library 
! 

RUN $MAC 

M A C > Q D Q D RSI S 

MAC>~C 

Ready 

RUN *LBR 

LBR>DTRLIB/IN=Qn 
LBRT 
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Ready 



run *pip.sav 
*lb:=dtrl.ib.olb 

fcDTRLIB ♦GLB/DE 
*QD.OBJ/DE 

*LB * RMS1 1 * TSK<40>/RE 
*"C 

Ready 



1 I n s 1 3 1 1 D 3 t a t r i •• • / <:■ t a s k s 
! 

RUN *TKB 
TKB>@QDRSTS.TKB 

Ready 

RUN QD'ICT 

CREATING QUERY DICTIONARY 
CREATING MESSAGE FILE 
POPULATING MESSAGE FILE 
BYE 

Ready 

RUN *TKB 

TKB>@DTRSTS.TKB 

Ready 

RUN $TKB 
TKB>@QERSTS.TKB 

Ready 

RUN *TKB 
TKB>6QCR8TS ♦ TKB 

Ready 

RUN * UTILITY 

UTILTY V06C-03 RSTS V06C-03 Basief 2/CoboI 

*CCL D T R - - S Y S T E M J (? D T R * TSK 

♦EXIT 

Ready 



! Clean up accounts 
! 

$PIP*SAV 
*SYSTEM:@ < 1 4 > = BTR * T S K 
♦SYSTEM i @=QDEXT . TSK 
♦SYSTEM ♦ GNQCPRS * TSK 
♦ DTR ♦ TSK/DE 
♦QDEXT ♦ TSK/DE 
♦QCPRS ♦ TSK/DE 
♦SYSTEM : ©QUERY ♦ DIC <0>/RE 
♦SYSTEM :@QUERY.MSG<40">/RE 
♦T 
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Ready 



1 Ready to run Dat&t i ieve acceptance test* 

C 

Ready 
HELLO 

R S T S M 6 C - 3 B a s i c + 2 / C o b o I J o b 1. 7 C 1 t 2 5 3 K B 2 2 9 A u S ••• 78 12 * 56 P M 
Job .1.2 is detached under this account 
Job number to attach to' !> 12 
Attaching to Job 12 

BUILD Complete 

Ready 

D f ft (? D "f R ♦ T S T 




The D ATATRIE VE-1 1 Acceptance Test Procedure 
is contained in Appendix A. 



Part of the BUILD program's processing is the DATATRIEVE-11 Acceptance 
Test. You must enter data at the points shown in Appendix A to execute this 
test properly. 

At the completion of the Acceptance Test, look for the lines 



! END OF QUERY/REPORT WRITER TEST 

EXIT 
BYE 

Ready 

Next, type the following under "Ready" 

RUN $PIP.SAV © 
*$<40>=YACHT,DAT ® 

*'z m 

Watch for the prompt Ready to appear. After "Ready" prints out, log off your 
system. DATATRIEVE-11 has been installed. 
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DATATRIEVE-11 Files 



Wrlra 'DATATEIEVE-tt''lias been instaiied, the following files reside in the 
indicated accounts. Note that the [SELF] designation represents your privi- 
leged account. 





ITTT XT 1 XT A MP 




[1,1] 


DTRLIB.OLB 


Datatrieve object library 


[1,2] 


DTR.TSK 


Datatrieve task image 


[1,2] 


QCPRS.TSK 


Dictionary COMPRESS program 


[1,2] 


QDEXT.TSK 


Dictionary EXTEND program 


[1,2] 


QUERY.DIC 


Data dictionary 


[1,2] 


QUERY.MSG 


Message file 


[1,2] 


YACHT.DAT 


Acceptance test data file 


[SELF] 


DTR.MAP 


Datatrieve map file 


[SELF] 


DTR.TST 


Acceptance test command file 


[SELF] 


DTRSTS.ODL 


Datatrieve overlay description file 


[SELF] 


DTRSTS.TKB 


Datatrieve task-build command file 


[SELF] 


MSGS.SEQ 


Message file (distributon format) 


[SELF] 


QCPRS.MAP 


Dictionary COMPRESS program map file 


[SELF] 


QCRSTS.ODL 


COMPRESS program overlay description file 


[SELF] 


QCRSTS.TKB 


COMPRESS program task-build command file 


[SELF] 


QDEXT.MAP 


Dictionary EXTEND program map file 


[SELF] 


QDICT.MAP 


Dictionary build program map file 


[SELF] 


QDICT.TSK 


Dictionary build program 


[SELF] 


QDRSTS.MAC 


Dictionary file-name source module 


[SELF] 


QDRSTS.ODL 


Dictionary build program overlay description file 


[SELF] 


QDRSTS.TKB 


Dictionary build program task-build command file 


[SELF] 


QERSTS.ODL 


EXTEND program overlay description file 


[SELF] 


QERSTS.TKB 


EXTEND program task-build command file 


[SELF] 


RMSRST.ODL 


RMS overlay description file 


[SELF] 


YACHT.SEQ 


Acceptance test data file (distribution format) 



RSTS/E V06C Installation Procedures 4-7 



Chapter 5 

Compressing the Data Dictionary and Extending 
DATATRIEVE-11 



This chapter contains procedures you can use to: 

1. Compress the data dictionary 

2. Extend DATATRIEVE-11 task space 

3. Extend (temporarily) the data dictionary 



5.1 Compressing the Data Dictionary 

You use the utility program, QCPRS, to periodically compress the data dic- 
tionary. As DATATRIEVE-11 is used, the data dictionary can accumulate 
deleted record headers, deoptimized index structures and scattered and frag- 
mented buckets; run QCPRS to reclaim the disk space wasted by this frag- 
mentation. 

To run QCPRS, invoke the program with the operating system command: 

RUN QCPRS m 

The utility program responds with the prompt: 

CPR> 

To compress the data dictionary, enter the command line in the form 
new -file=o Id-file 

to QCPRS, where old-file is the file name of the data dictionary, and new-file 
is the name of the compressed copy of the dictionary. 
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The default file name for both new-file and old- file is SY:QUERY.DIC; the 
UIC (or account) defaults to your directory. 

On RSX-11M and IAS systems, new- file and old- file can have the same 
name; either system creates a new version of the name. Under RSTS/E, 
however, the name must be different. The best strategy is to rename the 
dictionary to a suitable name, such as QUERY. BAK, and use QCPRS to copy 
it back to its original name, QUERY.DIC. 

QCPRS then prompts for an initial allocation for the new version of the file 
with the message: 

ENTER ALLOCATION FOR AREA 0: 

Enter a "best guess" for the new compressed version. If the value entered is too 
low, the file will be extended automatically to hold the contents of the original 
file. 

To terminate QCPRS, type (ctrl/z) after the prompt CPR>. 

The original file is not altered by QCPRS. It may be saved as a backup or 
deleted. 

An example of a typical QCPRS run follows: 

RUN QCPRS (RET) 

QUERY FILE COPY -COMPRESS UTILITY 
CPR> QUERY.DIC = SY:Clt2] QUERY.DIC © 
ENTER ALLOCATION FOR AREA 0: 250 (© 
CPR> tCTRpz) 



5.2 Extending DATATRIEVE-11 Task Space 

D ATATRIEVE-l 1 utilizes extend task space for RMS buffers, internal con- 
trol blocks, and SORT work space. When this space is exhausted during 
execution of a command, one of the following messages is printed: 

CENTRAL STORAGE POOL EXHAUSTED 
SORT WORK SPACE EXHAUSTED 
COMPILER STORAGE POOL EXHAUSTED 

There are two solutions to this problem. First, the amount of memory in use 
can be reduced by taking one or more of the following steps: 

1. Use the RELEASE command to release any unnecessary collections. 

2. Use the FINISH command to finish any unnecessary domains. 

3. If any DEFINE or DELETE commands have been issued, exit and re- 
invoke DATATRIEVE-11. 

Second, if the problem persists, the extend task size parameter in the 
DATATRIEVE-11 task build command file can be modified to increase the 
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size of DATATRIE VE-1 1 . To do this, edit the file DTRIAS.TKB (IAS 
System), or DTR11.3VLTKB (RS.X-11M System), ox DTRSTS.TKB CRET-S^ 
System). The syntax of the extend task size parameter is: 

EXTTSK = x x x x x 

where xxxxx is the number of decimal words that the task is to be extended. 
Next, rebuild DATATRIE VE-1 1 with the command(s): 

@DTR I AS * LNK ® (for IAS System) 

RUN $TKB m (for RSX-11M System) 

TKB> @DTR 1 i M ♦ TKB gT) 

RUN $TKB m (for RSTS/E System) 

TKB > SDTRSTS . TKB © 

Upon completion of the task build, DATATRIE VE-1 1 is ready for execution. 

5.3 Extending the Data Dictionary 

When DATATRIE VE-1 1 is installed in an RSX-11M System, RMS automat- 
ically extends the data dictionary file, should that file become full. However, 
all RSTS/E systems (and some IAS Systems) will return error messages indi- 
cating that the data dictionary is full. 

The reason for the message is that in RSTS/E Systems (and some IAS Sys- 
tems) any attempt to extend a file by a user who is not the owner of the file is 
rejected by RMS. 

To extend the size of the data dictionary, you can use the QDEXT utility 
program. Run the program by typing 

RUN QDEXT 

QDEXT then prompts for the name of the file (the data dictionary) and the 
number of blocks it is to be extended. 

» 

5.4 Automatic Spooling Under RSX-11M 

Automatic line printer spooling under RSX-11M is controlled by the global 
symbol SPL11M. If this symbol is set to 1 (as distributed), all PRINT and 
REPORT command references to the device LP: are redirected to disk, and 
queued to the spooler following request execution. If the symbol SPL11M is 
set to 0, line printer output is sent directly to the line printer. 

The SPL11M symbol is defined in the RSX-11M DATATRIE VE Task Build 
Command File DTR11M.TKB. To send line printer output directly to the line 
printer, edit the DTR11M.TKB file (setting SPL11M to 0), then run the Task 
Builder: 

RUN $TKB m 
TKB>@DTRi 1M.TKB ® 
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Appendix A 

Acceptance Test Procedure 



i 

! CLEAN UP FROM POSSIBLE PREVIOUS RUNS OF" TEST 
i 

DELETE YACHTS-SEQUENTIAL 9 

"YACHTS-SEQUENTIAL" has not been defined in the dictionar 
DELETE YACHTS? 

" Y A C H T S " h a s n o t been d e f i n e d i n the d i c t i o n a r y 
DELETE YACHT ? 

"YACHT" has not been defined in the dictionary 

.U fc. L. fc. I L r f \ .1 w i:_ - r c ia — r u u i s .1.1 y 

■ P R I C E - P E R - P U N D " h a s n o t b e e n d e f i n e d i n t h e d :L c t i o 1 "1 a r y 
DELETE STORE-YACHT i 

"STORE-YACHT" has not been defined in the dictionary 
D E L E T E I... A R E P R T ? 

" L A - R E P R T " h a s n o t b e e n d e f i n e d i n t h e d i c t i o n a r y 
1 

! DEFINE RECORD 

i 

DEFINE RECORD YACHT USING 
01 BOAT * 
03 TYPE* 

06 MANUFACTURER PIC X<10) 
QUERY - NAME IS BUILDER * 
06 MODEL PIC X"( 10) * 
03 SPECIFICATIONS 

QUER Y-NAME SPECS * 

06 RIG PIC X(6) . 

06 LENGTH-OVER- ALL PIC XXX 

QUERY-NAME IS LQA. 
06 DISPLACEMENT PIC 99999 
QUERY-HEADER IS " WEIGHT " 
ED IT-STRING IS ZZ.*ZZ9 
QUERY-NAME IS DISP. 
06 BEAM PIC 99* 
06 PRICE PIC 99999 

EDIT-STRING IS $$$?$*$ ♦? 
I! Re cord YACHT is 41 bytes Ion a 3 

DEFINE DOMAINS 

DEFINE DOMAIN YACHTS-SEQUENTIAL USING YACHT ON YACHT ♦SEQ 
DEFINE DOMAIN YACHTS USING YACHT ON YACHT ♦ DAT r 

DEFINE THE ACTUAL FILE FOR YACHTS 



DEFINE FILE YACHTS KEY-BUILDER ( DUP ) 9 KEY=M0DEL ( DUP » CHANGE ) 
ALLOCAT 1 0N = 30 5- SUPERCEDE 



! MAKE YACHTS ACCESSABLE BY OTHERS 
! 

DEFINEP YACHTS 2 r PU t * SHHHH - r W ! PASSWORD FOR WRITE 

DEFINEP YACHTS 3 f UIC , C* * *3 , R ! EVERYONE ELSE GETS READ 

DEFINEP YACHT 2»UICfC*»*3»R ! GIVE ACCESS TO RECORD DEFINITION* TOO 

SHOWP YACHTS 

.1. t u i c y i:: 3 1 .1. > 300 ::i * " rwmec ■ 

2vPWy " SHHHH " r "W" 

3rU.xc? i::*r*:]y "r« 

i 

I EiEFINE PROCEDURES 
! 

DEFINE PROCEDURE PRICE-PER-POUND 

PR I CE* 1 ♦ 00/D I SP ( • PR I CE " / " PER " / " POUND " ) US I NG ** ♦ 99 

END-PROCEDURE 

! 

DEFINE PROCEDURE STORE- YACHT 
STORE YACHTS VERIFY USING 
BEGIN 

IF BEAM EQ THEN ABORT "BAD BEAM" 

IF DISP EQ THEN ABORT "BAD DISPLACEMENT" 

IF LOA NOT BETWEEN 20 AND 60 THEN ABORT "BAD LENGTH" 

PRINT 

DISPLAY "CONFIRM WITH Y IF OK" 

IF *♦ CONFIRMATION NOT CONTAINING " Y " THEN ABORT " STORE ABORTED " 

END 

END-PROCEDURE 
! 

! COPY DATA FROM SEQUENTIAL TO INDEXED FILE 

READY YACHTS WRITE 
READY YACHTS-SEQUENTIAL 
SHOW READY 
Ready domains* 

YACHTS-SEQUENTIAL * RMS SEQUENTIAL r PROTECTED READ 

YACHTS: RMS INDEXED r PROTECTED WRITE 

FOR YACHTS-SEQUENTIAL STORE YACHTS USING BOAT-BOAT 



INISH YACHTS-SEQUENTIAL t 



TEST STORE 



PLEASE SUPPLY THE FOLLOWING VALUES J 



MANUFACTURER i HINKLEY 

MODEL * BERMUDA 

rig: YAWL 
length-over-all: 140 

displacement: 20000 

beam: 12 

price: 82000 

: STORE-YACHT 

Enter MANUFACTURER * HINKLEY 

Enter MODEL: BERMUDA 40 

Enter RIG : YAWL 

Enter LENGTH-OVER-ALL : 140 

Enter DISPLACEMENT: 20000 

Enter BEAM: 12 

Enter PRICE : 82000 

abort: bad length 

Execution term ins ted by "ABORT 
i 



40 



statement 
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PLEASE SUPPLY THE FOLLOW VALUES i 



KmOFftCTURERi 

model: 

RIG J 

length-over-all; 

displacement: 

beam: 

price; 

confirmation 



HINKOET 
BERMUDA 40 
YAWL 
40 

20*000 
1 2 

$82*000 
N 



: STORE- YACHT 

Enter MANUFACTURER* HINKLEY 

Enter MODEL : BERMUDA 40 

Enter RIG J YAWL 

Enter LENGTH -OVER-ALL : 40 

Enter DISPLACEMENT : 20 * 000 

Enter BEAM: 12 

Enter PRICE : $82 * 000 



LENGTH 
OVER- 
manufacturer model rig all weight beam price 

hinkley bermuda 40 yawl 40 20*000 12 $82*000 
display; confirm with y if ok 

Enter CONFIRMATION ;N 

abort: store aborted 

Execution terminated by "ABORT" statement 
i 

! CHANGE READY MODE FOR READ ACCESS 
j 

READY YACHTS 

FIND YACHTS WITH PRICE NE 

C52 records found II 

SORT BY LOAvDESC DISPLACEMENT 

SHOW ALL 

Domains : 

YACHTS-SEQUENTIAL 
YACHTS 

Records : 

YACHT 
Procedures : 

PRICE-PER-POUND 

STORE-YACHT 
Col lections : 

CURRENT 
Ready domains; 

YACHTS: RMS INDEXED* PROTECTED READ 
SHOW CURRENT 
Collection CURRENT 

Domain: YACHTS 

Number of records: 52 

No selected record 

Sort order: LENGTH-0 VER- ALL * DISPLACEMENT 
PRINT ALL 
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MANUFACTURER MODEL 



RIG 



LENGTH 
OVER- 
ALL WEIGHT BEAM PRICE 



WINDPOWER 


IMPULSE 


SLOOP 


16 




650 


07 


$3,500 


CAPE DORY 


TYPHOON 


SLOOP 


19 


1 


,900 


06 


$4,295 


VENTURE 


21 


SLOOP 


21 


1 


,500 


07 


$2,823 


VENTURE 




SLOOP 




2 


,000 


07 


$3,564 


EASTWARD 


HO 


M/S 


24 


7 


,000 


09 


$15,900 


I SLANDER 


BAHAMA 


SLOOP 




A 


,200 


yb 


$6,500 


IRWIN 


25 


SLOOP 


25 


5 


,400 


12 


$10,950 


CAPE DORY 


25 


SLOOP 


25 


4 


,000 


07 


$S , 995 


SALT 


19 


SLOOP 


25 


':> 


,600 


07 


$6,590 


WESTERLY 


CENTAUR 


SLOOP 


26 


6 


,700 


08 


$15,245 


GRAMPIAN 


26 


SLOOP 


26 


5 


,600 


OS 


$11 ,495 


AMERICAN 


26-MS 


M/S 


26 


5 


,500 


08 


$18,895 


TANZER 


26 


SLOOP 


26 


4 


,350 


09 


$11 ,750 


ALB IN 


79 


SLOOP 


26 


4 


,200 


10 


$17,900 


AMERICAN 


26 


SLOOP 


26 


4 


,000 


08 


$9,895 


HUNTER 


27 


SLOOP 


27 


6 


,500 


09 


$14,999 


ALB IN 


VEGA 


SLOOP 


27 


5 


,070 


08 


$18,600 


CAPE DORY 


28 


SLOOP 


28 


9 


,000 


09 


$21,990 


SABRE 


28 


SLOOP 


28 


7 


,400 


09 


$22,000 


GRAMPIAN 


28 


SLOOP 


28 


6 


,900 


10 


$14,475 


TANZER 


28 


SLOOP 


28 


6 


,800 


10 


$17,500 


ISLANDER 


28 


SLOOP 


28 


5 


,994 


10 


$15,908 


NORTHERN 


29 


SLOOP 


29 


7 


,250 


09 


$20,975 


IRWIN 


30 


SLOOP 


30 


10 


,000 


10 


$19,950 


HUNTER 


30 


SLOOP 


30 


9 


,500 


10 


$21,500 


GRAMPIAN 


30 


SLOOP 


30 


8 


,600 


09 


$17,775 


ISLANDER 


30 


SLOOP 


30 


8 


,600 


10 


$20,990 


ALBIN 


BALLAD 


SLOOP 


30 


7 


,276 


10 


$27,500 


CLIPPER 


CM 30 


SLOOP 


30 


3 


,800 


08 


$9,500 


RYDER 


S* CROSS 


SLOOP 


31 


13 


,600 


00 


$32,500 


BOMBAY 


CLIPPER 


SLOOP 


31 


9 


,400 


11 


$23,950 


WRIGHT 


SEAWIND II 


SLOOP 


32 


14 


,900 


00 


$34,480 


CHALLENGER 


32 


SLOOP 


32 


12 


,800 


11 


$31 ,835 


' DAY 


32 


SLOOP 


32 


11 


,000 


00 


$29,500 


BAYFIELD 


30/32 


SLOOP 


32 


9 


,500 


10 


$32,875 


CLIPPER 


CM 32 


SLOOP 


32 


4 


,500 


08 


$12,950 


GRAMPIAN 


34 


KETCH 


33 


12 


,000 


10 


$29,675 


GRAMPIAN 


2-34 


SLOOP 


34 


11 


,800 


10 


$29,675 


CARIBBEAN 


35 


SLOOP 


35 


18 


,000 


11 


$37,850 


CHRI8--CRAF 


CARIBBEAN 


SLOOP 


35 


18 


,000 


11 


$37,850 


CHALLENGER 


35 


SLOOP 


35 


14 


,800 


12 


$39,215 


I ♦ TRADER 


37 


KETCH 


36 


18 


, 600 


12 


$39,500 


ISLANDER 


36 


SLOOP 


36 


13 


,450 


11 


$31 ,730 


ALBERG 


37 MK II 


KETCH 


37 


20 


,000 


12 


$36,951 


IRWIN 


37 MARK II 


KETCH 


37 


20 


,000 


1 1 


$36,950 


NORTHERN 


37 


KETCH 


37 


14 


,000 


11 


$50,000 


LINDSEY 


39 


M/3 


39 


14 


, 500 


12 


$35 , 900 


CHALLENGER 


41 


KETCH 


41 


26 


,700 


13 


$51 ,228 


GULFSTAR 


41 


KETCH 


41 


22 


,000 


12 


$41 ,350 


ISLANDER 


FREEPORT 


KETCH 


41 




,000 


13 


$54,970 


COLUMBIA 


41 


SLOOP 


41 


20 


,700 


11 


$48,490 


OLYMPIC 


ADVENTURE 


KETCH 


42 


24 


• 250 


13 


$80,500 



A-4 Acceptance Test Procedure 



SELECT FIRST 
PRINT 



MANUFACTURER MODEL RIG 

WINDPOUER IMPULSE SLOOP 
SELECT 

PRINT BOAT* iPRICE-PER-POUND 



MANUFACTURER MODEL RIG 
CAPE DORY TYPHOON SLOOP 



! DEFINE REPORT PROCEDURE 

DEFINE PROCEDURE LOA-REPORT 
REPORT ON *»FILE 

SET REPORT~NAME=" JIM'S VERY OWN LISTING V OF "/" INTERESTING SAILBOATS'/ 

" (BY LENGTH) " 
SET LINES-PAGE=55* C0LUMNS-PAGE=72 
AT TOP OF LOA PRINT LOA (" LENGTH " ) 
PRINT TYPE* RIG* DISP* BEAM USING Z9 * PRICE 
AT BOTTOM OF LOA PRINT SKIP* COL 32* "*** AVERAGE ***"* 

AVERAGE DISP* AVERAGE BEAM* AVERAGE PRICE 
AT BOTTOM OF REPORT PRINT SKIP * "REPORT AVERAGES"* 

AVERAGE DISP* AVERAGE BEAM* AVERAGE PRICE 
AT BOTTOM OF PAGE PRINT SKIP* COL 20* 

"'"ANOTHER SERVICE OF QUERY ENTERPRISES" ' " 
REPORT END 
END-PROCEDURE 

! INVOKE REPORT (SUGGEST OUTPUT ON Ti:> 

: LOA-REPORT 
Enter FILE: TI i 



LENGTH 
OVER 

ALL WEIGHT BEAM PRICE 
16 650 07 $3*500 



LENGTH PRICE 

OVER PER 

ALL WEIGHT BEAM PRICE POUND 

19 1*900 06 $4*295 $2*26 



Acceptance Test Procedure A-5 



JIM'S VERY OWN LISTING 
OF 

INTERESTING SAILBOATS 3.1. - JUL -78 

(BY LENGTH) PAGE 1 



LENGTH MANUFACTURER MODEL RIG WEIGHT BEAM PRICE 

16 



vt x in x.' r uwcn 


TMPIH QP" 
xi i r ulol. 


c;i nnp 

1... IJ LJ 1 


O Jv 


7 


•P >J ! 


SAO 

\J V \J 




l ±* a. i i r- a r- 
HVCI\HUC 


*** 


/ c s\ 
O *J V 


/\ "7 
V / 


$3 


jyu 


CAPE DORY 


TYPHOON 


SLOOP 


1 *900 


6 


$4> 


295 




*** AVERAGE 


##* 


1 * 900 


06 


$4i 


295 


VENTURE 


21 


SLOOP 


1 *500 


7 


$2. 


823 




*** AVERAGE 


#** 


1 *500 


07 


$2) 


823 


VENTURE 




SLOOP 


2*000 


7 


$3) 


564 




*** AVERAGE 


**# 


2*000 


07 


$3. 


564 


EASTWARD 


HO 


M/S 


7? 000 


9 


$15 


>900 


ISLANDER 


BAHAMA 


SLOOP 


4*200 


8 


$6> 


-500 




*** AVERAGE 


*** 


5r600 


08 


$lli 


-200 


IRWIN 


25 


SLOOP 


5*400 


12 


$10> 


950 


CAPE DORY 


25 


SLOOP 


4 * 000 


7 


$8! 


995 


C Al T 
DHL. 1 


•I o 

.1 7 


o l. u u r 




7 

f 


?o ) 


■ S9A 
i J7y 




* * >r- HvCrVnut 






08 


$8 


» 845 


WESTERLY 


CENTAUR 


SLOOP 


6*700 


8 


$15 


,245 


GRAMPIAN 


26 


SLOOP 


5*600 


8 


$11 


f495 


AMERICAN 


26-MS 


M/S 


5 * 500 


8 


$18 


.895 


TANZER 




oLUUr 




y 


V .1 .1 




ALBIN 


79 


SLOOP 


4*200 


10 


$17 


f900 


AMERICAN 


26 


SLOOP 


4 * 000 


8 


$9 


»895 




*** AVERAGE 


#** 


5*058 


08 


$14 


f 196 


HUNTER 


27 


SLOOP 


6*500 


9 


$14 


,999 


ALBIN 


VEGA 


SLOOP 


5 * 070 


8 


$18 


r600 




*** AVERAGE 


*#* 


5 * 785 


08 


$16 


>799 


CAPE DORY 


23 


SLOOP 


9*000 


9 


$21 


f990 


SABRE 


28 


SLOOP 


7*400 


9 


$22 


- 000 


GRAMPIAN 


28 


SLOOP 




10 


$ 1 4 


1 47 / 5 


TANZER 


28 


SLOOP 


6*800 


10 


$17 


► 500 


"ANOTHER 


SERVICE OF QUE! 


■;Y ENTERP 


RISES' 









A-6 Acceptance Test Procedure 



JIM'S VERY OWN LISTING 
OF 

INTERESTING SAILBOATS 31-JUL-78 

(BY LENGTH) PAGE 2 



LENGTH MANUFACTURER MODEL RIG WEIGHT BEAM PRICE 



ISLANDER 


28 


SLOOP 


5? 994 


10 


$15*908 




**# AVERAGE 




7 * 21.8 


09 


$18 y 374 


NORTHERN 


29 


SLOOP 


7*250 


9 


$20*975 




*** AVERAGE 


*## 


7y250 


09 


$20 y 975 


IRWIN 


30 


SLOOP 


10 v 000 


10 


$19*950 


HUNTER 


30 


SLOOP 


9 ? 500 


10 


$21 y 500 


GRAMPIAN 


30 


SLOOP 


8 y 600 


9 


$17 ? 775 


ISLANDER 


30 


SLOOP 


8*600 


10 


$20*990 


ALBIN 


BALLAD 


SLOOP 


7*276 


10 


$27*500 


CLIPPER 


CM 30 


SLOOP 


3 y 800 


8 


$9*500 




*** AVERAGE 


*** 


7»962 


09 


$19*535 


RYDER 


S* CROSS 


SLOOP 


13 y 600 





$32*500 


BOMBAY 


CLIPPER 


SLOOP 


9y400 


11 


$23*950 




*** AVERAGE 


**# 


11 y 500 


05 


$28*225 


WRIGHT 


SEAWIND II 


SLOOP 


14 y 900 





$34*480 


CHALLENGER 


32 


SLOOP 


12 y 800 


1 1 


$31 * 835 


U LlAY 


32 


SLOOP 


1 1 y 000 





$29 * 500 


BAYFIELD 


30/32 


SLOOP 


9y500 


10 


$32*875 


CLIPPER 


CM 32 


SLOOP 


4 y 500 


8 


$12*950 




*** AVERAGE 


### 


10 y 540 


05 


$28*328 


GRAMPIAN 


34 


KETCH 


12 y 000 


10 


$29*675 




#Xc# AVERAGE 


$ )j()J( 


12 y 000 


10 


$29 * 675 


GRAMPIAN 


2-34 


SLOOP 


11 y 800 


10 


$29*675 




*** AVERAGE 


*## 


11 y 800 


10 


$29*675 


CARIBBEAN 


35 


SLOOP 


IS y 000 


11 


$37*850 


CHRIS-CRAF 


CARIBBEAN 


SLOOP 


18y000 


11 


$37*850 


CHALLENGER 


35 


SLOOP 


14 y 800 


12 


$39*215 




*** AVERAGE 


*** 


16 y 933 


11 


$38*305 


I* TRADER 


37 


KETCH 


18 y 600 


12 


$39*500 


ISLANDER 


36 


SLOOP 


13y450 


11 


$31 * 730 




*** AVERAGE 


*** 


16y025 


11 


$35*615 



"ANOTHER SERVICE OF QUERY ENTERPRISES " 



Acceotance Test Procedure A-7 



JIM'S VERY OWN LISTING 

OP- 
INTERESTING SAILBOATS 31-JUL-78 
<BY LENGTH) PAGE 3 



LENGTH 
37 



39 



41 



42 



REPORT AVERAGES 



MANUFACTURER 



ALBERG 

IRWIN 

NORTHERN 



LINDSEY 



CHALLENGER 
GULFSTAR 
ISLANDER 
COLUMBIA 



OLYMPIC 



MODEL 



37 MK II 
37 MARK II 
37 



RIG 



KETCH 
KETCH 
KETCH 



WEIGHT BEAM 



*** AVERAGE *** 
39 M/S 
*** AVERAGE *** 



41 
41 

FREEPORT 
41 



KETCH 
KETCH 
KETCH 
SLOOP 



*** AVERAGE *** 
ADVENTURE KETCH 
*** AVERAGE *** 



20? OOO 
20 * 000 
14 * 000 

18*000 

14*500 

14*500 

26*700 
22*000 
22*000 
20 * 700 

22*850 

24*250 

24*250 

10* 169 



"ANOTHER SERVICE OF QUERY ENTERPRISES" 
INVOKE REPORT (SUGGEST OUTPUT ON LP I ) 

* LOA-REPORT 
Enter FILE: LP! 

RATTLE UPDATE 

FIND YACHTS WITH BEAM^O 
C5 records found!] 
PRINT ALL 

LENGTH 
OVER 



1ANUFACTURER 


MODEL 


RIG 


ALL 


WEIGHT 


BEAM 


PRICE 


METALMAST 


GALAXY 


SLOOP 


32 


9*500 


00 




' DAY 


32 


SLOOP 


32 


11*000 


00 


$29*500 


RYDER 


S. CROSS 


SLOOP 


31 


13*600 


00 


$32*500 


TA CHIAO 


FANTASIA 


SLOOP 


35 


23*200 


00 




WRIGHT 


SEAWIND II 


SLOOP 


32 


14*900 


00 


$34*480 



SELECT FIRST * PRINT 

MANUFACTURER MODEL 

METALMAST GALAXY 

READY YACHTS MODIFY 
i 



RIG 
SLOOP 



...ENGTH 
OVER- 
ALL WEIGHT BEAM 



PRICE 



32 



9 * 500 00 



12 
11 
11 

11 

12 

12 

13 
12 
13 
11 

12 

13 

13 

09 



PRICE 

$36*951 
$36*950 
$50*000 

$41*300 

$35*900 

$35*900 

$51*228 
$41 *350 
$54*970 
$48*490 

$49*009 

$80*500 

$80*500 

$24*843 



A-8 Acceptance Test Procedure 



! RESPOND WITH 47 (OR SOMETHING) 

j 

HOTJTFY BEAM 
Enter BEAM* 47 
PRINT TYPE , BEAM 



MANUFACTURER MODEL BEAM 



METALMAST GALAXY 47 



! RESPOND WITH 48 (OR SOMETHING) 

MODIFY ALL BEAM 
Enter BEAM* 48 
I 

PRINT ALL BEAM 



BEAM 



48 
48 
48 
48 
48 



! RESPOND EACH TIME WITH (PLEASE) 
FOR CURRENT PRINT TYPE THEN MODIFY BEAM 



MANUFACTURER MODEL 

METALMAST GALAXY 
Enter BEAM t 

' DAY 32 
Enter BEAM: 

RYDER S* CROSS 

Enter BEAM: 

TA CHIAO FANTASIA 
Enter BEAM: 

WRIGHT SEAWIND II 

Enter BEAM: 



READY YACHTS READ 
PRINT ALL 



LENGTH 
OVER- 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 



METALMAST 


GALAXY 


SLOOP 


32 


9,500 


00 


' DAY 


32 


SLOOP 


32 


11,000 


00 


RYDER 


S* CROSS 


SLOOP 


31 


13,600 


00 


TA CHIAO 


FANTASIA 


SLOOP 


35 


23,200 


00 


WRIGHT 


SEAWIND II 


SLOOP 


32 


14,900 


00 



$29,500 
$32,500 

$34,480 



! CHECK MULTIPLE COLLECTIONS AND STATISTICAL FUNCTIONS 

FIND SMALLS IN YACHTS WITH L0A<24 AND PRICE NE 
C4 records found] 



Acceptance Test Procedure A-9 



! 

FIND BIGGIES IN YACHTS WITH L0A>40 AND PRICE NE 

C5 records found!] 

! 

SHOW COLLECTIONS 
Col lections I 

BIGGIES (also CURRENT) 

SMALLS 

! I 
PRINT AVERAGEI DISP 

WEIGHT 

23* 130 

! 

PRINT MAX DISP 

WEIGHT 

26 * 700 
i 

PRINT AVERAGE PRICE OF BIGGIES* AVERAGE PRICE OF SMALLS 
PRICE PRICE 

$55*307 $3*545 
i 

SORT SMALLS BY LOA* DISP 
SORT BIGGIES BY LOA* DISP 
SELECT FIRST SMALLS 
SELECT LAST BIGGIES 

PRINT SMALLS . BOAT * SKIP * BIGGIES ♦ BOAT 

LENGTH 
OVER- 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 

WINDPOWER IMPULSE SLOOP 16 650 07 $3*500 

OLYMPIC ADVENTURE KETCH 42 24*250 13 $80*500 

FINAL GALA TEST! 

PRINT YACHTS WITH LOA EQ MAX LOA OF YACHTS 

LENGTH 
OVER- 
MANUFACTURER MODEL RIG ALL WEIGHT BEAM PRICE 

OLYMPIC ADVENTURE KETCH 42 24*250 13 $80*500 

PEARSON 419 KETCH 42 21*000 13 

i 

! END OF QUERY/REPORT WRITER TEST 



A-10 Acceptance Test Procedure 



DATATRIEVE-ll(Vl.l) 
IAS, RSX-11M, RSTS/E 
Installation Guide 

READER'S COMMENTS Order Mql AA-H169A-TG 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well-organized? Please make suggestions for improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of user/reader that you most nearly represent. 

□ Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

□ User with little programming experience 

□ Student programmer 

□ Other (please specify) 

Name Date 

Organization 

Street 

City State Zip Code 

or 

Country 
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